Skip to content

v3.3: apply the ABNF for path parameter names#5300

Open
karenetheridge wants to merge 1 commit intoOAI:v3.3-devfrom
karenetheridge:ether/3.3-parameter-name-patterns
Open

v3.3: apply the ABNF for path parameter names#5300
karenetheridge wants to merge 1 commit intoOAI:v3.3-devfrom
karenetheridge:ether/3.3-parameter-name-patterns

Conversation

@karenetheridge
Copy link
Copy Markdown
Member

(port of #5263)

Header parameter names have already been adjusted.

The ABNF for the query component of URIs is at RFC3986 §3.4, but percent-encoding is used, which allows for the use of any character. Additionally, cookies using style=form are also percent-encoded and therefore allow any character.

Moreover, cookie parameter names are percent-encoded when using style=form, and even for style=cookie they are not used in serialization of objects when explode=true, so a restriction on cookie parameter names is not added here; however applications should apply their own restrictions, following the "cookie-name" and "cookie-value" ABNFs at RFC6265 §4.1.1 (and ensure that all disallowed characters are percent-encoded when using style=form).

  • schema changes are included in this pull request

Header parameter names have already been adjusted.

The ABNF for the query component of URIs is at RFC3986 §3.4, but
percent-encoding is used, which allows for the use of any character.
Additionally, cookies using style=form are also percent-encoded and therefore
allow any character.

Moreover, cookie parameter names are percent-encoded when using style=form,
and even for style=cookie they are not used in serialization of objects when
explode=true, so a restriction on cookie parameter names is not added here;
however applications should apply their own restrictions, following the
"cookie-name" and "cookie-value" ABNFs at RFC6265 §4.1.1 (and ensure that all
disallowed characters are percent-encoded when using style=form).
@karenetheridge karenetheridge force-pushed the ether/3.3-parameter-name-patterns branch from 81d9083 to 4e80b2b Compare April 23, 2026 16:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant